home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr25 / sio100a.zip / SIOUSER.TXT < prev    next >
Text File  |  1993-05-21  |  40KB  |  925 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                      USERS MANUAL
  26.  
  27.               SIO.SYS and VSIO.SYS, Serial Communications Device Driver
  28.                for OS/2 V2 (and up) and its Virtual DOS Machines (VDM).
  29.  
  30.                         Copyright (c) 1993 by Raymond L. Gwinn
  31.                                  12469 Cavalier Drive
  32.                               Woodbridge, Virginia 22192
  33.                                  All Rights Reserved
  34.  
  35.                                      May 19, 1993
  36.  
  37.                                         Email
  38.                                  CompuServe 72570,157
  39.                           Internet 72570.157@compuserve.com
  40.                          FidoNet 1:265/104 (Routed Mail Only)
  41.  
  42.                                          FAX
  43.                                      703-494-0595
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                                                                           i
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                      INTRODUCTION
  60.  
  61.           SIO.SYS and VSIO.SYS are  companion device drivers for Version  2
  62.           (and up) of the OS/2 operating system.
  63.  
  64.           Both drivers (SIO/VSIO) have been coded with performance in mind,
  65.           possibly sacrificing  some compatibility.   For this  reason, SIO
  66.           and VSIO are not exact replacements for the  OS/2 drivers COM and
  67.           VCOM.  However, all serial  communications programs tested by the
  68.           author work correctly using SIO/VSIO.
  69.  
  70.           This manual is intended for the SIO user.  A separate Application
  71.           Programmers manual is being written.
  72.  
  73.           This manual and the software distributed with it is provided with
  74.           no guarantees.  Use it at your own risk.
  75.  
  76.           Product Support
  77.  
  78.           Extensive testing has been done to insure that this product works
  79.           on the  widest possible range  of OS/2 V2  (and up) systems.   In
  80.           most  cases, problems  can  be resolved  by  reading this  manual
  81.           carefully.
  82.  
  83.           Email and  FAX are the  only methods of support  provided.  Voice
  84.           support would overwhelm the author.  If, after reading the manual
  85.           carefully, you are unable  to resolve a problem, please  fill out
  86.           PROBLEM.TXT (adding information as necessary) and Email/FAX it to
  87.           one of the following addresses:
  88.  
  89.                                         Email
  90.                                  CompuServe 72570,157
  91.                           Internet 72570.157@compuserve.com
  92.                          FidoNet 1:265/104 (Routed Mail Only)
  93.  
  94.                                          FAX
  95.                                      703-494-0595
  96.  
  97.           PROBLEM.TXT is included in the distribution ZIP.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.                                                                          ii
  106.  
  107.                                   TABLE OF CONTENTS
  108.  
  109.  
  110.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   i
  111.                Product Support  . . . . . . . . . . . . . . . . . . . .   i
  112.  
  113.           WHAT IS SIO . . . . . . . . . . . . . . . . . . . . . . . . .   1
  114.  
  115.           WHAT IS VSIO  . . . . . . . . . . . . . . . . . . . . . . . .   2
  116.  
  117.           GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . .   3
  118.  
  119.           Installing SIO/VSIO . . . . . . . . . . . . . . . . . . . . .   3
  120.                Quick Start  . . . . . . . . . . . . . . . . . . . . . .   3
  121.  
  122.           COMMAND LINE OPTIONS  . . . . . . . . . . . . . . . . . . . .   4
  123.                COM1 thru COMn . . . . . . . . . . . . . . . . . . . . .   4
  124.                I/O port address . . . . . . . . . . . . . . . . . . . .   4
  125.                IRQ number . . . . . . . . . . . . . . . . . . . . . . .   4
  126.                Forced 16550A  . . . . . . . . . . . . . . . . . . . . .   4
  127.  
  128.           AUTOMATIC IRQ ASSIGNMENT  . . . . . . . . . . . . . . . . . .   5
  129.  
  130.           DOS SETTINGS  . . . . . . . . . . . . . . . . . . . . . . . .   6
  131.                SIO_Allow_Access_COMn  . . . . . . . . . . . . . . . . .   6
  132.                SIO_Virtualize_COM_Ports . . . . . . . . . . . . . . . .   6
  133.                SIO_Virtualize_16550A  . . . . . . . . . . . . . . . . .   6
  134.                SIO_Virtual_RTS_is_HS  . . . . . . . . . . . . . . . . .   6
  135.  
  136.           Differences between SIO/VSIO and COM/VCOM . . . . . . . . . .   7
  137.  
  138.           PROBLEMS AND SOLUTIONS  . . . . . . . . . . . . . . . . . . .   8
  139.                IRQ for a port appears to be wrong . . . . . . . . . . .   8
  140.                The modem will not initialize  . . . . . . . . . . . . .   8
  141.                WinFax does not work well  . . . . . . . . . . . . . . .   8
  142.                Telemate does not recognize VX00 as a FOSSIL . . . . . .   8
  143.                Output is very slow at 2400 baud and below . . . . . . .   8
  144.  
  145.           IRQ SHARING ON ISA  . . . . . . . . . . . . . . . . . . . . .   9
  146.  
  147.           Appendix A, Hardware Port and IRQ Assignments . . . . . . .    10
  148.                Addresses and IRQs for COM1 and COM2 . . . . . . . . .    10
  149.                Defacto standard for COM3 and COM4 . . . . . . . . . .    10
  150.                Addresses and IRQ for COM3 through COM8 on the PS/2  .    10
  151.  
  152.           Appendix B, SIO Chips . . . . . . . . . . . . . . . . . . .    11
  153.                8250 . . . . . . . . . . . . . . . . . . . . . . . . .    11
  154.                8250A  . . . . . . . . . . . . . . . . . . . . . . . .    11
  155.                16450  . . . . . . . . . . . . . . . . . . . . . . . .    11
  156.                16C451 . . . . . . . . . . . . . . . . . . . . . . . .    12
  157.                16550 (Non A . . . . . . . . . . . . . . . . . . . . .    12
  158.                16550A . . . . . . . . . . . . . . . . . . . . . . . .    12
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.                                                                         iii
  167.  
  168.                16550AF  . . . . . . . . . . . . . . . . . . . . . . .    12
  169.                16550AFN . . . . . . . . . . . . . . . . . . . . . . .    12
  170.                16550s Made by Western Digital . . . . . . . . . . . .    13
  171.                16C551 . . . . . . . . . . . . . . . . . . . . . . . .    13
  172.                16C552 . . . . . . . . . . . . . . . . . . . . . . . .    13
  173.                16C554 . . . . . . . . . . . . . . . . . . . . . . . .    13
  174.                82510  . . . . . . . . . . . . . . . . . . . . . . . .    13
  175.  
  176.           Appendix C, Multi-Port Serial I/0 Cards . . . . . . . . . .    14
  177.                STB 4COM . . . . . . . . . . . . . . . . . . . . . . .    14
  178.  
  179.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . .    15
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.                                                                           1
  188.  
  189.                                      WHAT IS SIO
  190.  
  191.           SIO is  a Serial Input/Output  (SIO) communications  driver.   It
  192.           provides an interface between application programs and the serial
  193.           communications hardware.
  194.  
  195.           SIO had been designed  as a high performance replacement  for the
  196.           OS/2  device driver  COM.SYS.    SIO.SYS  does not  support  some
  197.           features  that are  provided  by COM.SYS.    In the  view of  the
  198.           author,  these features  are rarely  used and  they inhibit  good
  199.           performance on the vast majority of systems.  See the programmers
  200.           reference manual  for  information about  the  known  differences
  201.           between COM.SYS and SIO.SYS.
  202.  
  203.           SIO only works with 8250 (TYPE) serial I/O devices.  Such devices
  204.           include  the 8250A, 16450, 16550,  16550A and the  82510.  If you
  205.           have a PC  that is an IBM  or near compatible which has  a serial
  206.           communication  port, it is likely  that it contains  one of these
  207.           devices.  SIO  will identify the type  of serial devices that  it
  208.           finds at load time.
  209.  
  210.           Like other  Device  Drivers, SIO  will  do very  little  standing
  211.           alone.  There must be an application(s) program to use SIO before
  212.           you will gain benefit.
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.                                                                           2
  221.  
  222.                                      WHAT IS VSIO
  223.  
  224.           VSIO  is a Virtual Device  Driver (VDD).   Virtual device drivers
  225.           provide services  for DOS  programs executing under  OS/2.   Most
  226.           Virtual Device Drivers emulate  a specific hardware device and/or
  227.           BIOS service.   The primary job of a Virtual  Device Driver is to
  228.           convert   misbehaved   DOS   input/output   into   well   behaved
  229.           input/output.
  230.  
  231.           Using the protection mechanism  of the 386 (and up)  processor, a
  232.           Virtual Device Driver can instruct OS/2  to trap all input/output
  233.           for  given hardware  ports.   Once  trapped,  the Virtual  Device
  234.           Driver   (VDD)  appropriately  routes   information  to/from  the
  235.           Physical Device Driver (PDD) and to/from the DOS program.
  236.  
  237.           VSIO creates  a  virtual (imaginary)  16550A or  16450 (UART)  in
  238.           software.   VSIO does not emulate any  BIOS services.  All of the
  239.           hardware  registers of  the virtual  UART are simulated  by VSIO.
  240.           VSIO does not attempt  to simulate the timing of the  real UARTs.
  241.           DOS programs that depend on the timing of real hardware UARTs may
  242.           have problems executing under VSIO.
  243.  
  244.           All  DOS programs  that execute  under VSIO  should  have RTS/CTS
  245.           handshaking  enabled regardless of the baud rate.  Note that this
  246.           enabling  of RTS/CTS  handshaking is  independent of  the RTS/CTS
  247.           handshaking used by SIO.
  248.  
  249.           The virtualization (simulation) provided by  VSIO is not (and can
  250.           not  be) exact.  However,  most well written  DOS programs should
  251.           not have problems.
  252.  
  253.           VSIO  will only  work  with SIO  installed  and the  versions  of
  254.           SIO/VSIO must match.  If VSIO refuses to install, you most likely
  255.           have  a version  mismatch.   VSIO will  not work  with  any other
  256.           device driver like COM.SYS.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.                                                                           3
  265.  
  266.                                    GETTING STARTED
  267.  
  268.           Installing SIO/VSIO
  269.  
  270.           SIO  is distributed  as a  ZIP file.   To extract  the individual
  271.           files  from the distribution file you need the program PKUNZIP or
  272.           an  equivalent.   PKUNZIP  is  a product  of  PKWARE  and can  be
  273.           downloaded from  almost any  bulletin  board system  (BBS).   You
  274.           probably already have PKUNZIP and know how to use it, otherwise I
  275.           doubt that  you would be reading  this.  When PKUNZIP  is used to
  276.           extract the various files, -AV should appear after each file name
  277.           as it is extracted.  In addition, the message:
  278.  
  279.                Authentic files Verified!
  280.  
  281.           should appear after the extraction process.  If this message does
  282.           not appear, or appears with a  name other than Raymond L.  Gwinn,
  283.           the file is not an original SIO distribution file.
  284.  
  285.           The  only file  that the  basic user  actually needs  is SIO.SYS.
  286.           Virtual  DOS machine (VDM) users  will also want  VSIO.SYS.  Copy
  287.           one  or  both  of  these  files  to  a  convenient  directory  or
  288.           subdirectory on your system.
  289.  
  290.           Quick Start
  291.  
  292.           Copy  SIO.SYS and  VSIO.SYS to  the root  directory of  your boot
  293.           drive or diskette.
  294.  
  295.           If you  are going to  use standard  communications ports,  either
  296.           COM1 or COM2 on an  ISA buss (AT or clone), or  COM1 through COM4
  297.           on a PS/2, then add the following line to your CONFIG.SYS file:
  298.  
  299.                DEVICE=SIO.SYS
  300.                DEVICE=VSIO.SYS
  301.  
  302.           Be sure to REMark out the COM.SYS and VCOM.SYS device  drivers if
  303.           they exist in your CONFIG.SYS.
  304.  
  305.           With the above  statements you will be able to  use standard COM1
  306.           and/or COM2 (if they exist) on any PC system know to the author.
  307.  
  308.           If your setup is more complex, you must read on.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.                                                                           4
  317.  
  318.                                  COMMAND LINE OPTIONS
  319.  
  320.           The  command line options are  included in the  command line that
  321.           loads SIO  in the  CONFIG.SYS  file.   VSIO has  no command  line
  322.           options.  Command line options are usually grouped by port within
  323.           parenthesis.
  324.  
  325.           If you  use only COM1 and/or  COM2, at the standard  IRQ and port
  326.           addresses,  you will not need any command line options.  However,
  327.           up  to four serial communications  ports, COM1 thru  COM4, can be
  328.           specified at any base port address and any IRQ.   On PS/2 systems
  329.           and some  ISA  cards, SIO/VSIO  supports multiple  communications
  330.           devices sharing the same IRQ.
  331.  
  332.           The basic command line syntax is as follows:
  333.  
  334.                DEVICE=SIO.SYS (Cn, An, In, Ig, Fc) [(Cn, An, In, Ig, Fc)]
  335.  
  336.           Where
  337.                "Cn"  is the comm port number (1  thru 4) or the string COM1
  338.                thru COMn.
  339.  
  340.                "An" is a  hexadecimal number that defines the base hardware
  341.                I/O port address for the communications port.
  342.  
  343.                "In" is  an IRQ number (0  thru 15) or the  string IRQ0 thru
  344.                IRQ15.  Is  is best if one allows SIO  to determine the IRQ,
  345.                see AUTOMATIC IRQ ASSIGNMENT below.
  346.  
  347.                "Ig"  is an ignored parameter.   If exists for compatibility
  348.                with COM.SYS.
  349.  
  350.                "Fc" is the Forced 16550A chip parameter.  If an F is placed
  351.                in  this  position,  a  16550A  UART  chip  type  is  forced
  352.                regardless of the automatically detected chip type.
  353.  
  354.           For  a PC  with  COM1 and  COM2  of standard  configuration,  the
  355.           following command line will load SIO correctly:
  356.  
  357.                DEVICE=SIO.SYS (1, 3F8, 4) (2, 2f8, 3)
  358.  
  359.           A more readable, but identical, command line is:
  360.  
  361.                DEVICE=SIO.SYS (COM1,3F8,IRQ4) (COM2,2F8,IRQ3)
  362.  
  363.           Forcing a 16550A on COM1 would be as follows:
  364.  
  365.                DEVICE=SIO.SYS (COM1,3F8,IRQ4,,F) (COM2,2F8,IRQ3)
  366.  
  367.           In a similar manner,  up to four serial communications  ports can
  368.           be defined and supported by SIO and VSIO.
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.                                                                           5
  377.  
  378.  
  379.                                AUTOMATIC IRQ ASSIGNMENT
  380.  
  381.           SIO  will  automatically  locate the  IRQ  that  a  comm port  is
  382.           attached  to.   The  IRQ used  by SIO  for a  given comm  port is
  383.           assigned in the following manner:
  384.  
  385.           1 - If an IRQ is specified  in the SIO command line then that IRQ
  386.           is used.  However, SIO will  display a warning message if the IRQ
  387.           seems to be other than specified.
  388.  
  389.           2 -  If no  IRQ is  specified in  the command  line,  and if  SIO
  390.           detected the IRQ then the detected IRQ is used.
  391.  
  392.           3 - If no  IRQ is specified in the command, and  if SIO could NOT
  393.           detect  an IRQ then  the default IRQ  for the comm  port is used.
  394.           SIO will also display a warning message in this case.
  395.  
  396.           The following STYLE command  line is recommended for all  but the
  397.           most unusual systems.  That is, specify only the  port number for
  398.           those above COM2 (to tell SIO to support those ports) and let SIO
  399.           do the rest.
  400.  
  401.           DEVICE=SIO.SYS (COM3) (COM4)
  402.  
  403.           If you do not have  a COM3 or COM4, or if the mouse  is using the
  404.           only  comm port above COM2 then the following command line should
  405.           be used.
  406.  
  407.           DEVICE=SIO.SYS
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.                                                                           6
  416.  
  417.                                      DOS SETTINGS
  418.  
  419.           VSIO  gets  its operational  characteristics  from  DOS Settings.
  420.           Several basic DOS Settings  are provided.  They specify  the type
  421.           of  access  (if  any)  that  a  DOS  program  is  to  have  to  a
  422.           communication port that SIO controls.
  423.  
  424.           All of the  DOS Settings default  to what  most users should  use
  425.           most of  the time (which is  ON).  Also, all of  the DOS Settings
  426.           are prefixed with SIO_.
  427.  
  428.           The provided DOS Settings and their meaning follow:
  429.  
  430.                "SIO_Allow_Access_COMn" (where  n is  1 thru  4).  This  DOS
  431.                setting defaults  to ON.  If this  setting is turned OFF for
  432.                any or all of the ports, the DOS program will not be allowed
  433.                any access to that port(s).
  434.  
  435.                "SIO_Virtualize_COM_Ports"  This Dos setting defaults  to ON
  436.                and it applies to  all communications ports used by  the DOS
  437.                session.  When ON, this DOS  setting means VSIO is to act as
  438.                an interface between the SIO and the DOS program.  When OFF,
  439.                the DOS program is given direct access to the hardware ports
  440.                of the UART(s).
  441.  
  442.                "SIO_Virtualize_16550A"  This DOS setting defaults to ON and
  443.                it  applies to  all  communications ports  used  by the  DOS
  444.                session.  When ON, VSIO will  simulate a 16550A.  When  OFF,
  445.                VSIO will simulate a 16450.   Some DOS programs may not work
  446.                when  a 16550A is simulated.   Turning this  setting off may
  447.                allow the program to work (but slower).
  448.  
  449.                "SIO_Virtual_RTS_is_HS"  This DOS setting defaults to ON and
  450.                it applies  to  all communications  ports  used by  the  DOS
  451.                session.  When ON,  VSIO treats RTS as a  handshaking signal
  452.                from the DOS session.  When OFF, VSIO passed the RTS setting
  453.                directly to  the hardware.  This setting  MUST be on for all
  454.                high speed DOS communications.   The only application, known
  455.                to  the author, where this signal may (should) be turned off
  456.                is DOS programs that use true half duplex.
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                                                                           7
  465.  
  466.                       Differences between SIO/VSIO and COM/VCOM
  467.  
  468.           What  follows is  some  of the  differences between  SIO/VSIO and
  469.           COM/VCOM that are know to the author.
  470.  
  471.           1 -  COM.SYS will  automatically seek  out and  support four
  472.                comm   ports,  COM1   through   COM4.     SIO.SYS  will
  473.                automatically seek out and  support only COM1 and COM2.
  474.                If SIO.SYS is to support more than two comm ports, they
  475.                must be defined in the command line that loads SIO.SYS.
  476.                For  example, DEVICE=SIO.SYS  (COM3) (COM4)  will cause
  477.                SIO.SYS to support four comm ports.
  478.  
  479.           2 -  In  the  absence  of  overrides in  the  command  line,
  480.                COM.SYS will seek  out four comm ports  in the sequence
  481.                of I/O ports 3F8h, 2F8h, 3E8h and 2E8h.  The first port
  482.                found in this sequence is given the logical name  COM1,
  483.                the second is COM2 etc.   This means that the comm port
  484.                at  2F8h  could become  COM1.   In  the opinion  of the
  485.                author, this confuses some uses to frustration.
  486.  
  487.                With no  command line  overrides, SIO.SYS uses  a fixed
  488.                I/O port concept.   That is, COM1 is always at I/O port
  489.                3F8h,  COM2 is  always at  2F8h, etc.   Another  way of
  490.                looking  at this is;   if no  comm port  exists at port
  491.                3F8h, then you  do not have  a COM1.  SIO.SYS  will not
  492.                move another  (found) comm  port into the  logical COM1
  493.                slot.
  494.  
  495.           3 -  VSIO  opens a  comm  port for  a  DOS session  with  sharing
  496.                allowed.    VCOM  uses  an  "exclusive  use"  open  for  DOS
  497.                sessions.
  498.  
  499.           4 -  SIO.SYS  always  controls  the  FIFOs  of  the  16550  UART.
  500.                SIO.SYS will  not allow an application program  (OS2 or DOS)
  501.                to disable the FIFOs of a real 16550.
  502.  
  503.           5 -  SIO.SYS  will accept any number  between 50 and  115200 as a
  504.                valid baud  rate.  For  example, if  an application  program
  505.                attempts to set a baud rate of 9990 bps, COM.SYS will reject
  506.                it and SIO.SYS will accept it.
  507.  
  508.           6 -  The last decimal digit of  a baud rate given to SIO  must be
  509.                zero.  SIO.SYS will not support baud rates like 75 or 134.5.
  510.                If given, they will be rounded to 80 and 130 respectively.
  511.  
  512.           7 -  SIO/VSIO execute faster than COM/VCOM.  This means that some
  513.                applications, that are timing  dependant, may not work under
  514.                SIO/VSIO that do work under COM/VCOM.
  515.  
  516.           8 -  VSIO optionally (and by default)  simulates a 16550A for DOS
  517.                sessions.  VCOM simulates a 8250/16450.
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                           8
  526.  
  527.  
  528.                                 PROBLEMS AND SOLUTIONS
  529.  
  530.           1 -  Port already in use is displayed.
  531.  
  532.                This message is displayed when the  comm port or the IRQ  is
  533.                in use.  If the comm port is not actually in use, the IRQ is
  534.                most likely in use.
  535.  
  536.           2 -  SIO  displays  a warning  message that  the  IRQ for  a port
  537.                appears to be wrong, but the port works.
  538.  
  539.                SIO probably detected more than one IRQ attached to the comm
  540.                port.  This  indicates a possible hardware problem with your
  541.                system that you may want to have checked.
  542.  
  543.           3 - The modem will not initialize.
  544.  
  545.                Configure  your comm  program(s) to  insert a  delay between
  546.                modem  initialization characters  as  they are  sent to  the
  547.                modem.
  548.  
  549.           4 - WinFax does not work well.
  550.  
  551.                The  modem init strings set by WinFax (for some modems) will
  552.                work in the  single-layered comm world  of DOS and  Windows.
  553.                However,  these modem  init  strings will  not  work in  the
  554.                multi-layered comm environment used by OS/2.   Specifically,
  555.                in some cases, WinFax sets Xon/Xoff flow control (only) with
  556.                the modem.  Ideally,  both Xon/Xoff and Hardware handshaking
  557.                needs to be set.  If only one  handshake can be set, set the
  558.                modem to Hardware handshake.  For USR FAX modems, use &H3.
  559.  
  560.           5 - Telemate does not recognize VX00 as a FOSSIL.
  561.  
  562.                Set the baud rate in Telemate to less than 57600.
  563.  
  564.           6 - Output is very slow at 2400 baud and below.
  565.  
  566.                This is a  bug in  several BBS programs  that originated  in
  567.                QuickBBS.   The problem  has been  corrected in QuickBBS  by
  568.                Steve Gabrilowitz,  QuickBBS's current author.   Inform  the
  569.                author  of your comm program  of the problem  and to contact
  570.                Steve Gabrilowitz for additional information.
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.                                                                           9
  579.  
  580.                                   IRQ SHARING ON ISA
  581.  
  582.           Sharing the  same IRQ for  multiple communications  ports on  ISA
  583.           systems is not  for the weak  of heart  (or mind).   If you  have
  584.           problems  with shared IRQs, DO  NOT contact the  author.  Contact
  585.           the board or computer manufacturer for help.
  586.  
  587.           Some general rules are as follows:
  588.  
  589.           1 - Two different  boards (plugged into different slots)  can not
  590.           share the same IRQ.  This is a hardware limitation of ISA systems
  591.           and can  not be corrected by  software.  This means  that you can
  592.           not plug  in two internal modems,  set them for the  same IRQ and
  593.           expect them to work.   This does not apply to PS/2  systems.  The
  594.           problem  of multiple boards sharing the same IRQ was corrected in
  595.           the PS/2's buss design.
  596.  
  597.           2 - SIO can not (will not) share an IRQ with other device drivers
  598.           at  the same time.   SIO releases  IRQs that it  is currently not
  599.           using.    This  is  different  form  how  COM.SYS  works.    This
  600.           difference may show  up as  an unexpected "port  already in  use"
  601.           error that  does not occur with COM.SYS.  I have received reports
  602.           that the SDLC  drivers try  to concurrently share  IRQs with  the
  603.           ASYNC driver.  SIO.SYS will not allow this while COM.SYS will.
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.                                                                          10
  612.  
  613.                     Appendix A, Hardware Port and IRQ Assignments
  614.  
  615.           I have  obtained the following information  from various sources.
  616.           Accuracy is not guaranteed.  In fact, nothing in this document is
  617.           guaranteed.
  618.  
  619.           Addresses and IRQs for COM1 and COM2
  620.  
  621.                COM1 uses 03F8h and IRQ4
  622.                COM2 uses 02F8h and IRQ3
  623.  
  624.           Defacto standard for COM3 and COM4 for PC, XT and AT
  625.  
  626.                COM3 uses 03E8h and IRQ4
  627.                COM4 uses 02E8h and IRQ3
  628.  
  629.           Addresses and IRQ for COM3 through COM8 on the PS/2
  630.  
  631.                COM3 uses 3220h and IRQ3
  632.                COM4 uses 3228h and IRQ3
  633.                COM5 uses 4220h and IRQ3
  634.                COM6 uses 4228h and IRQ3
  635.                COM7 uses 5220h and IRQ3
  636.                COM8 uses 5228h and IRQ3
  637.  
  638.           All PCs (know to the author) prior to the  PS/2 only used 12 bits
  639.           to address  hardware I/0 ports.   Systems prior  to the PS/2  and
  640.           EISA can not address the standard PS/2 addresses for COM3 through
  641.           COM8.   If an AT or  below attempts to address  COM3 through COM8
  642.           using the standard addresses, only the low 12 bits of the address
  643.           are used.   That is,  the high digit  of the  hexadecimal address
  644.           will be ignored.   This means that any  reference to COM3 through
  645.           COM8 will actually address ports 220h through 22Fh.
  646.  
  647.           You  should avoid  expansion boards that  use ports  220h through
  648.           22Fh unless the expansion board is a serial I/O board. 
  649.  
  650.           SIO  will  (attempt  to)  determine   the  hardware  architecture
  651.           (ISA/EISA  and PS/2)  that it  is being  executed on and  use the
  652.           appropriate  hardware  port  addresses  for  COM1  thru  COM4  as
  653.           defaults.
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.                                                                          11
  662.  
  663.                                 Appendix B, SIO Chips
  664.  
  665.  
  666.           The following is a collection of comments developed from hearsay,
  667.           random documents, experience,  and technical specifications.  So,
  668.           take it with a grain of salt.  Order information from the various
  669.           manufactures if you want accurate information.
  670.  
  671.           Very  good   reference   book   are   available   from   National
  672.           Semiconductor Corporation.   The covers  most of the  SIO devices
  673.           (also called UARTs) that you will find in many PCs and clones.  I
  674.           am  not sure  that books  can be  ordered directly  from National
  675.           semiconductor.  They  may   require  that  you  get  it   from  a
  676.           distributor.  In  any case, the  address on the  back of the  one
  677.           manual is:
  678.  
  679.                National Semiconductor Corporation
  680.                2900 Semiconductor Drive
  681.                P.O. Box 58090
  682.                Santa Clara, CA 95052-8090
  683.  
  684.                Tel:(408)721-5000
  685.                TWX:(910)339-9240
  686.  
  687.           8250
  688.  
  689.           As best that I know, the  8250 was the first SIO chip (integrated
  690.           circuit) that  was used  by the IBM  PC and many  clones.   In my
  691.           opinion, it was  a poor choice on  the part of IBM.   I feel many
  692.           superior devices, at  comparable prices, were  readily available.
  693.           At that time, I feel the 8251A or the 8530 would have been better
  694.           choices.  But, they used the 8250 and therefore we must use it.
  695.  
  696.           From  a hardware standpoint the 8250 is a relatively slow device.
  697.           It is advisable that programmers not perform successive inputs or
  698.           outputs to this device.  It seems that software programs can load
  699.           the various registers of the 8250 faster than it can  process the
  700.           information.   The  8250  had  a  total  of  7  registers.    The
  701.           specifications state that 56kb is the maximum baud rate.
  702.  
  703.           8250A
  704.  
  705.           I believe the 8250A  is the 8250 with some bug fixes.   I have no
  706.           idea  what  the bugs  may  have  been.   A  quick  glance at  the
  707.           specifications  shows the speed of the 8250  and 8250A to be much
  708.           the same.   The  8250A added  an 8th  register.   This additional
  709.           register enables software to detect if an 8250 is installed.  The
  710.           specifications state that 56kb is the maximum baud rate.
  711.  
  712.           16450
  713.  
  714.           The 16450 seems to be a  speeded up version of the 8250A.   There
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                                                          12
  723.  
  724.           is no  direct way (that  I know  of) for software  to detect  the
  725.           difference between an 8250A and a 16450.  I believe the 16450 was
  726.           developed to  eliminate the need  for software  to insert  delays
  727.           between successive  accesses to  the device.   The specifications
  728.           indicate the 16450 is a much faster device than its predecessors.
  729.           The additional speed is only the speed at which the processor can
  730.           access the  device.  The maximum baud rate for the 16450 is still
  731.           stated at  56kb.  However, I  have been told by  some people that
  732.           they have run the 16450 successfully at much higher  speeds. I do
  733.           not believe there was ever a 16450A.
  734.  
  735.           16C451
  736.  
  737.           The 16C451 is  a CMOS version of the  16450.  CMOS is a  term for
  738.           the material  and manufacturing  process used  to make  the part.
  739.           CMOS typically uses less  power than other technologies.   If you
  740.           are  not  designing hardware,  you should  view  the 16C451  as a
  741.           16450.
  742.  
  743.           16550 (Non A)
  744.  
  745.           It is  hard to  find a  16550 (Non A).   I  was told  by National
  746.           Semiconductor  that they  did everything  they could  to  get all
  747.           16550s back.   SIO will detect a 16550  and tell you if  you have
  748.           one.    I am  told that  the 16550  was  installed in  early PS/2
  749.           systems.
  750.  
  751.           The 16550  was the first  shot at  a FIFOed version  of the  8250
  752.           family  from  National semiconductor.    However, I  was  told by
  753.           National Semiconductor  that  the  FIFOs  of the  16550  are  not
  754.           reliable and  they should not be enabled.  SIO will treat a 16550
  755.           like  a  16450.   In  this  mode, they  are  reliable.   National
  756.           Semiconductor would not  provide me with a  specification for the
  757.           16550.  However, I suspect  its maximum baud rate is the  same as
  758.           the 16550A which is 256kb.
  759.  
  760.  
  761.           16550A, 16550AF and 16550AFN
  762.  
  763.           In the  manuals  that I  have,  National Semiconductor  does  not
  764.           explain  the differences between the  16550A and the  16550AF.  I
  765.           suspect the AF part may have a few bug fixes.  I believe the N in
  766.           AFN  describes  packaging,  ceramic versus  plastic,  DIP  versus
  767.           surface mount etc.
  768.  
  769.           In the  opinion of  the author,  there is  no substitute  for the
  770.           16550A (and its successors) in the 8250 type  series.  The 16550A
  771.           is compatible with most software written for the entire family of
  772.           8250  type devices.  Programs  that are 16550A  aware can provide
  773.           much improved performance over previous devices.
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.                                                                          13
  782.  
  783.           The  maximum  baud rate  for the  16550A  is specified  at 256kb.
  784.           However, due to the hardware design of the PC et al, 115kb is the
  785.           maximum baud rate that can be programmed by software.
  786.  
  787.           The 16550A can be  plugged into the same socket  that contains an
  788.           8250, 8250A  or 16450.  If  your SIO expansion board  has the SIO
  789.           chips  in  sockets,  you can  upgrade  to  the  16550A by  simply
  790.           removing the old chips and replacing them with 16550As.
  791.  
  792.           The key to  the performance increase of the  16550A is its FIFOs.
  793.           It has 16 byte FIFOs for both transmit and receive data.
  794.  
  795.           16550s Made by Western Digital
  796.  
  797.           I have been told, but I have not verified for myself, that 16550s
  798.           made  by Western  Digital have  a problem  with their  FIFOs when
  799.           working at 2400 baud or below.
  800.  
  801.           16C551
  802.  
  803.           The  16C551 is  a CMOS  version of  the 16550AF.   See  the above
  804.           description of  the 16C451 for a discussion of CMOS.  Do not feel
  805.           you need to upgrade from a 16550A or AF to a 16C551.  There is no
  806.           gain from an existing users point of view.
  807.  
  808.           16C552
  809.  
  810.           The 16C552 is two 16C551s on a single chip.
  811.  
  812.           16C554
  813.  
  814.           The 16C554 is four 16C551s on a single chip.
  815.  
  816.           82510
  817.  
  818.           I  believe Intel is the only company that manufactures the 82510.
  819.           The 82510  is feature rich with several  modes of operation.  Its
  820.           default  mode is to operate as  a 16450.  The 82510  has a 4 byte
  821.           FIFO  for both  transmit and  receive  data.   A 4  byte FIFO  is
  822.           sufficient to provide significant performance over a basic 16450.
  823.  
  824.           The  82510 is small in size.  Therefore,  it is found in many lap
  825.           tops.
  826.  
  827.           The 82510 is  somewhat of a sleeper.  I believe  it would be much
  828.           more widely used if Intel had promoted it more.  However, given a
  829.           choice  between  the 82510  and the  16550A,  I would  select the
  830.           16550A.
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.                                                                          14
  839.  
  840.                        Appendix C, Multi-Port Serial I/0 Cards
  841.  
  842.           I have  received many  requests for information  about multi-port
  843.           serial I/O  card.  I will  describe the boards that  I know about
  844.           (or have heard about) here.  I will add  to the list as I receive
  845.           precise information from users or develop it myself.
  846.  
  847.           My personal experience  and testing of SIO  is with a board  from
  848.           B&B computer.   However,  I had  to modify the  board to  make it
  849.           share IRQs.  Therefore I will not discuss this board.
  850.  
  851.           STB 4COM  (ISA buss)
  852.  
  853.           I am very impressed with the STB 4COM card, they  have almost got
  854.           it.   Yes, its the  same company that makes  the VGA cards.   The
  855.           4COM  card uses a 16554  which is the  equivalent of four 16550A.
  856.           Comm ports can use IRQs 2/9, 3, 4, 5, 10, 11, 12, and 15.  Any or
  857.           all  ports can  share IRQs,  and they  have done  this right.   I
  858.           tested SIO  with all four  ports of  the 4COM on  IRQ12 and  they
  859.           worked  correctly.  The user can  select any of the following I/O
  860.           port address for a comm port:  3F8, 2F8, 3E8, 2E8, 1A8, 1E8, 1F8,
  861.           2A8.
  862.  
  863.           I purchased my 4COM  card (for $119) from Steve  Winter, 800-735-
  864.           5266 or 919-286-1502.
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.                                                                          15
  873.  
  874.                                         INDEX
  875.  
  876.           16450 . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  877.           16550 Non A . . . . . . . . . . . . . . . . . . . . . . . . .  12
  878.           16550A  . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  879.           16550AF . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  880.           16550AFN  . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  881.           16550s Made by Western Digital  . . . . . . . . . . . . . . .  13
  882.           16C451  . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  883.           16C551  . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  884.           16C552  . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  885.           16C554  . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  886.           8250  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  887.           8250A . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  888.           82510 . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  889.           Addresses and IRQ for COM3 through COM8 on the PS/2 . . . . .  10
  890.           Addresses and IRQs for COM1 and COM2  . . . . . . . . . . . .  10
  891.           Allow_Access_COMn . . . . . . . . . . . . . . . . . . . . . . . 6
  892.           Appendix A, Hardware Notes  . . . . . . . . . . . . . . . . .  10
  893.           Appendix B, SIO Chips . . . . . . . . . . . . . . . . . . . .  11
  894.           Appendix C, Multi-Port Serial I/0 Cards . . . . . . . . . . .  14
  895.           AUTOMATIC IRQ ASSIGNMENT  . . . . . . . . . . . . . . . . . . . 5
  896.           COMn already in use . . . . . . . . . . . . . . . . . . . . . . 8
  897.           CONFIG.SYS  . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  898.           Defacto standard for COM3 and COM4  . . . . . . . . . . . . .  10
  899.           Differences between SIO/VSIO and COM/VCOM . . . . . . . . . . . 7
  900.           DOS SETTINGS  . . . . . . . . . . . . . . . . . . . . . . . . . 6
  901.           FIFO  . . . . . . . . . . . . . . . . . . . . . . . . . .  12, 13
  902.           GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . . . 3
  903.           Installing SIO/VSIO . . . . . . . . . . . . . . . . . . . . . . 3
  904.           IRQ . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4, 5
  905.           IRQ SHARING ON ISA  . . . . . . . . . . . . . . . . . . . . . . 9
  906.           National Semiconductor Corporation  . . . . . . . . . . . . .  11
  907.           PDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  908.           Physical Device Driver  . . . . . . . . . . . . . . . . . . . . 2
  909.           PKUNZIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  910.                Authentic files  . . . . . . . . . . . . . . . . . . . . . 3
  911.           PROBLEMS AND SOLUTIONS  . . . . . . . . . . . . . . . . . . . . 8
  912.           Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  913.           RTS/CTS handshaking . . . . . . . . . . . . . . . . . . . . . . 2
  914.           SIO Chips . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  915.           SIO_Virtual_RTS_is_HS . . . . . . . . . . . . . . . . . . . . . 6
  916.           STB 4COM  . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  917.           UART  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  918.           VDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  919.           Virtual Device Driver . . . . . . . . . . . . . . . . . . . . . 2
  920.           Virtualize_16550A_For_COM . . . . . . . . . . . . . . . . . . . 6
  921.           Virtualize_COM_Ports  . . . . . . . . . . . . . . . . . . . . . 6
  922.           WHAT IS SIO . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  923.           WHAT IS VSIO  . . . . . . . . . . . . . . . . . . . . . . . . . 2
  924.           WinFax  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  925.